Subject: Cancel_Conversation Changes

From: "Richard L. Daugherty ((919) 254-6838)" <[email-masked]>
Date: Tue, 19 Sep 95 16:31:40 EDT

Attached is the change page write up for the Cancel_Conversation
changes.  This identifies the changes to the current CPIC Specification.
Please review and provide comments by Oct 2nd.

Thanks,

Rich Daugherty

----- start of change pages

--- Changes to CPIC 2.0 Specification SC31-6180-01 ---

p. 40 "Canceling Outstanding Operations" last sentence
      change "do not return a return code" to
      "returns with the return code of CM_CONVERSATION_CANCELLED."

p. 108 Accept_Incoming (CMACCI)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       CM_OPERATION_INCOMPLETE

p. 111 Allocate (CMALLC)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       CM_OPERATION_INCOMPLETE

p. 118 Cancel_Conversation
       Replace the second paragraph from the top with:

       Cancel_Conversation results in the immediate termination
       of any operations in progress on the specified conversation.
       The terminated operations will have a return code value of
       CM_CONVERSATION_CANCELLED.  No other guarantees are given
       on the results of the terminated operations.  For example,
       when a Cancel_Conversation call has been issued while a
       non-blocking Send_Data call is outstanding, the program
       cannot determine how much data was actually moved from the
       application buffer, nor can the program rely on the validity
       of any output parameters, except for return_code, for the
       terminated Send_Data call.

p. 118 Cancel_Conversation
       In note 2, first paragraph:
       change "CM_DEALLOCATED_ABEND" to "CM_DEALLOCATED_ABEND or
       CM_RESOURCE_FAILURE_RETRY".

       change "CM_DEALLOCATED_ABEND_BO" to "CM_DEALLOCATED_ABEND_BO
       or CM_RESOURCE_FAILURE_RETRY_BO"

p. 121 Confirm (CMCFM)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       CM_OPERATION_INCOMPLETE

p. 124 Confirmed (CMCFMD)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       CM_OPERATION_INCOMPLETE

p. 131-134 Deallocate (CMDEAL)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       each occurrence of CM_OPERATION_INCOMPLETE

p. 140 Deferred_Deallocate (CMDFDE)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       CM_OPERATION_INCOMPLETE

p. 177 Flush (CMFLUS)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       CM_OPERATION_INCOMPLETE

p. 180 Include_Partner_In_Transaction (CMINCL)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       CM_OPERATION_INCOMPLETE

p. 186 Prepare (CMPREP)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       CM_OPERATION_INCOMPLETE

p. 188-190 Prepare_To_Receive (CMPTR)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       each occurrence of CM_OPERATION_INCOMPLETE

p. 197-200 Receive (CMRCV)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       each occurrence of CM_OPERATION_INCOMPLETE

p. 208 Receive_Expedited_Data (CMRCVX)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       CM_OPERATION_INCOMPLETE

p. 212 Request_To_Send (CMRTS)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       CM_OPERATION_INCOMPLETE

p. 217-220 Send_Data (CMSEND)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       each occurrence of CM_OPERATION_INCOMPLETE

p. 226-229 Send_Error (CMSERR)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       each occurrence of CM_OPERATION_INCOMPLETE

p. 235 Send_Expedited_Data (CMSNDX)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       CM_OPERATION_INCOMPLETE

p. 313 Wait_For_Conversation (CMWAIT)
       Add CM_CONVERSATION_CANCELLED to conversation_return_code
       list after CM_CONV_DEALLOC_AFTER_SYNCPT

p. 322 Pseudonyms and Integer Values
       Add CM_CONVERSATION_CANCELLED    53
       to return code portion of table

p. 339 Add the following before the entry for CM_CONVERSATION_ENDING
       CM_CONVERSATION_CANCELLED
          This return code is returned for outstanding operations
          when the conversation was locally terminated by a
          CANCEL_CONVERSATION call.

--- changes to Automatic Data Conversion ---

Receive_Mapped_Data (CMRCVM)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       each occurrence of CM_OPERATION_INCOMPLETE

Send_Mapped_Data (CMSNDM)
       Add CM_CONVERSATION_CANCELLED to return_code list after
       each occurrence of CM_OPERATION_INCOMPLETE

---- end of change pages